Skip to content

[Monitor] Add Metric Alerts Query GA 2026-01-01 swagger#43587

Closed
sidanmor wants to merge 42 commits into
Azure:mainfrom
sidanmor:metric-alerts-query-ga-swagger-stream1-v2
Closed

[Monitor] Add Metric Alerts Query GA 2026-01-01 swagger#43587
sidanmor wants to merge 42 commits into
Azure:mainfrom
sidanmor:metric-alerts-query-ga-swagger-stream1-v2

Conversation

@sidanmor

@sidanmor sidanmor commented May 28, 2026

Copy link
Copy Markdown
Member

Review Focus

TL;DR

The stream1 changes correctly promote Metric Alerts Query to GA 2026-01-01, switch package-2025-08 manifest wiring to the GA swagger, and include stable example files aligned to swagger x-ms-examples references.

Key Files to Review

  • specification/monitor/resource-manager/Microsoft.Insights/Insights/MetricAlertApi/main.tsp
  • specification/monitor/resource-manager/Microsoft.Insights/Insights/readme.md
  • specification/monitor/resource-manager/Microsoft.Insights/Insights/stable/2026-01-01/metricAlert.json
  • specification/monitor/resource-manager/Microsoft.Insights/Insights/stable/2026-01-01/examples/*.json

Risk Areas

  • package-2025-08 manifest switch is the highest-impact surface for downstream consumers, but remains within approved scope.

Design Alignment

Implementation is aligned with approved discovery/design/plan/LLD: GA version added, stable swagger/examples produced, preview compatibility preserved, and manifest scope constrained.

Summary

  • Add GA API version 2026-01-01 for Metric Alerts Query.
  • Add stable swagger + examples under Insights/stable/2026-01-01.
  • Update Insights/readme.md package-2025-08 input-file to stable/2026-01-01/metricAlert.json.

Validation

  • Local JSON parse validation for GA swagger/examples.
  • git diff --check clean.

Work item: metric-alerts-query-ga-swagger

@microsoft-github-policy-service microsoft-github-policy-service Bot added the Monitor Monitor, Monitor Ingestion, Monitor Query label May 28, 2026
@github-actions

github-actions Bot commented May 28, 2026

Copy link
Copy Markdown

Next Steps to Merge

Next steps that must be taken to merge this PR:
  • ❌ This PR is in purview of the ARM review (label: ARMReview). This PR must get ARMSignedOff label from an ARM reviewer.
    This PR is not ready for ARM review (label: NotReadyForARMReview). This PR will not be reviewed by ARM until relevant problems are fixed. Consult the rest of this Next Steps to Merge comment for details.
    Once the blocking problems are addressed, add to the PR a comment with contents /azp run. Automation will re-evaluate this PR and if everything looks good, it will add WaitForARMFeedback label which will put this PR on the ARM review queue.
    For details of the ARM review, see aka.ms/azsdk/pr-arm-review
  • ❌ This PR is NotReadyForARMReview because it has the VersioningReviewRequired label.
  • ❌ This PR has at least one change violating Azure versioning policy (label: VersioningReviewRequired).
    To unblock this PR, either a) introduce a new API version with these changes instead of modifying an existing API version, or b) follow the process at aka.ms/brch.
  • ❌ The required check named TypeSpec Validation has failed. Refer to the check in the PR's 'Checks' tab for details on how to fix it and consult the aka.ms/ci-fix guide


Comment generated by summarize-checks workflow run.

@github-actions github-actions Bot added ARMReview new-api-version resource-manager RPaaS TypeSpec Authored with TypeSpec WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required labels May 28, 2026
@github-actions

github-actions Bot commented May 28, 2026

Copy link
Copy Markdown

API Change Check

APIView identified API level changes in this PR and created the following API reviews

Language API Review for Package
TypeSpec MetricAlertApi
JavaScript @azure/arm-monitor
Python azure-mgmt-monitor
Go sdk/resourcemanager/monitor/armmonitor
Java com.azure.resourcemanager:azure-resourcemanager-monitor
C# Azure.ResourceManager.Monitor

Comment generated by After APIView workflow run.

@ravimeda ravimeda left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ARM API review for PR #43587 at head SHA 6556222ebaa2c43e513a2ae86f98e1107e6cdeee. 7 findings (0 new blocking, 1 existing blocking, 1 existing warning, 5 suggestions). All findings verified by ARM API Review Critic subagent (1 iteration; 4 finding-level corrections folded in).

Comment thread specification/monitor/resource-manager/Microsoft.Insights/Insights/readme.md Outdated

@ravimeda ravimeda left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ARM API review for PR #43587 at head SHA 6556222ebaa2c43e513a2ae86f98e1107e6cdeee. 7 findings (0 new blocking, 1 existing blocking, 1 existing warning, 5 suggestions). All findings verified by ARM API Review Critic subagent (1 iteration; 4 finding-level corrections folded in).

Comment thread specification/monitor/resource-manager/Microsoft.Insights/Insights/readme.md Outdated
@ravimeda ravimeda added ARMChangesRequested and removed WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required labels May 29, 2026
@github-actions github-actions Bot added VersioningReviewRequired <valid label in PR review process>add this label when versioning review is required NotReadyForARMReview and removed new-api-version ARMChangesRequested labels Jun 3, 2026
@sidanmor sidanmor changed the title [Monitor] Add Metric Alerts Query GA 2026-06-01 swagger [Monitor] Add Metric Alerts Query GA 2026-01-01 swagger Jun 9, 2026
@sidanmor sidanmor added the PublishToCustomers Acknowledgement the changes will be published to Azure customers. label Jun 11, 2026
@sidanmor

Copy link
Copy Markdown
Member Author

/azp run

@azure-pipelines

Copy link
Copy Markdown
You have several pipelines (over 10) configured to build pull requests in this repository. Specify which pipelines you would like to run by using /azp run [pipelines] command. You can specify multiple pipelines using a comma separated list.

@sidanmor

Copy link
Copy Markdown
Member Author

/azp run TypeSpec Validation

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines could not run because the pipeline triggers exclude this branch/path.

Co-authored-by: sidanmor <6368621+sidanmor@users.noreply.github.com>
Copilot AI and others added 8 commits June 21, 2026 14:54
…le-version readme.md to fix Avocado MULTIPLE_API_VERSION

The failing CI job (Swagger Avocado - Analyze Code) reported MULTIPLE_API_VERSION on
Insights/readme.md because its default tag package-2025-08 contains swaggers from many
different API version folders (2015–2026).

The fix avoids touching Insights/readme.md (which would re-trigger the check) by:
1. Adding the GA stable/2026-01-01/metricAlert.json swagger generated from TypeSpec
2. Adding all stable/2026-01-01/examples/ metric alert example files
3. Adding stable/2026-01-01/readme.md with a single-version default tag (package-2026-01-01)
   referencing both activityLogAlerts_API.json and metricAlert.json

With readme.md present in stable/2026-01-01/, avocado's findTheNearestReadme traces the
new swagger files to this single-version readme (no MULTIPLE_API_VERSION), and
Insights/readme.md with its composite multi-version default tag is never evaluated.

Co-authored-by: sidanmor <6368621+sidanmor@users.noreply.github.com>
… Email.Subject typo in examples

Co-authored-by: sidanmor <6368621+sidanmor@users.noreply.github.com>
Co-authored-by: sidanmor <6368621+sidanmor@users.noreply.github.com>
…code-job

Copilot/fix swaggervavocado analyze code job
@sidanmor sidanmor added WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required and removed VersioningReviewRequired <valid label in PR review process>add this label when versioning review is required labels Jun 25, 2026
@github-actions github-actions Bot added the VersioningReviewRequired <valid label in PR review process>add this label when versioning review is required label Jun 25, 2026
@github-actions github-actions Bot added NotReadyForARMReview and removed WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required labels Jun 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ARMReview Monitor Monitor, Monitor Ingestion, Monitor Query NotReadyForARMReview PublishToCustomers Acknowledgement the changes will be published to Azure customers. resource-manager RPaaS TypeSpec Authored with TypeSpec VersioningReviewRequired <valid label in PR review process>add this label when versioning review is required

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants